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INTRODUCTION 



What is this document? 

The Apple lie Computer Firmware ERS Changes: RS-232 Printer and Mouse Port I/O 
document describes the programming commands for controlling these ports. This 
document was written by Apple's internal Apple lie computer engineering team. 

This information eventually was publicly documented by Apple Computer, Inc. in 
the Apple lie Reference Manual. 

Firmware is the read-only (ROM) memory stored In the Apple lie. 

ERS = Engineering Reference Specification. 

Chels is one of many internal Apple Computer, Inc. code names for the Apple He 
computer. Other code names were: Lolly, ET (extra terrestrial), lib (b=book). Up 
(p=portable), Pippin, VLC (very low cost), Elf, Yoda, Teddy, Jason, Sherry, Zelda. 

Facts about this document 

Author: 

Apple Computer Inc 
Document dates of record: 

September 1983 

Owner: 

Organization: DigiBarn Computer Museum (www.digibarn.com) 

Curator: Bruce Darner (http://www.damer.com/) 



This digital rendition of this document is available for non-commercial, educational 
and research purposes with the requirement to provide attribution and share-alike 
under the Creative Commons license provided on page 4. 

All other uses require the agreement of the DigiBarn Computer Museum (contact 
through www.digibarn.com). 
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PROPERTY STATEMENT 



This document is tiie property of the DigiBarn Computer Museum which is offering it 
under the following Creative Commons License found on page 4. 

Under the terms of this license you must credit the DigiBarn Computer Museum and 
Apple Computer, Inc. if whole or part of this document is used for non-commerical, 
educational or research purposes. All other uses require the agreement of the 
DigiBarn Computer Museum (contact through www.diglbarn.com). 
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/^creative 
^commons 

C O M M O N S DEED 



Attribution - Non Commercial - No Derivative Worlds 2.5 

You are free: 

* to copy, distribute, display, and perform the worl< 

Under the following conditions: 




Attribution. 

You must attribute the worl< In the manner specified by the author 
or licensor. 




Noncommercial. 

You may not use this work for commercial purposes. 



No Derivative Works. 

You may not alter, transform, or build upon this work. 

* For any reuse or distribution, you must make clear to others the license 
terms of this work. 

* Any of these conditions can be waived if you get permission from the 
copyright holder. 

Your fair use and other rights are in no way affected by the above. 

This is a human-readable summary of the Legal Code. 
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Disclaimer 



The Commons Deed is not a license. It is simply a handy reference for 
understanding the Legal Code (the full license) — it is a human-readable expression 
of some of Its l<ey terms. Think of it as the user-friendly interface to the Legal Code 
beneath. This Deed itself has no legal value, and its contents do not appear in the 
actual license. 

Creative Commons is not a law firm and does not provide legal services. 
Distributing of, displaying of, or linking to this Commons Deed does not create an 
attorney-client relationship. 
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RECEIVED 

Date: SeoteniDer 1J983 C'P P ]^h'^ 

To: Distribution ^^^ " '"°^ 

From: Rich UilliaraE Wrtnr 

Subject: Chels firnware ERS changes ^^"^ Vicior 

The RS232 printer and the Mouse speci-fications have been changed from revision 12 o^f the firnware O'f the 

ERS. Since the changes to the serial printer port are large, they are being sent out in a neno. A revision 

113 0^ the ERS will be done and will be available in fine nail slots everywhere. The changes add new functions 
and capabilities to the firnware. 

RS232 printer 
The comands to the printer driver have been changed to nake then closer to the Super serial card. The 
old functions were: 

nnn ;Uhere nnn is the (decinal) line width. 

I ;Enable video echo 

J {Disable LF, Enable video echo 

K ;Di sable LF 

L ;Set LF 

M ;Set LF, Enable video echo 

N ;Disable video echo 

'x ;Set comand chacter to *x. * = control, x = character. 
The new connands are: 

nnnB ;Set the baud rate to nnn. nnn sane as Super Serial card. 

1 = SO baud 

2 = 75 baud 

3 = 109.92 baud 

4 - 134.58 baud 

5 - 150 baud 

6 = 300 baud 

7 - 600 baud 

8 = 1200 baud 

9 = 1800 baud 

10 = 2400 baud 

11 = 3600 baud 

12 = 4800 baud 

13 - 7200 baud 

14 - 9600 baud 

15 = 19200 baud 

nnD ;Set the data fornat. nnn sane as SS card. 
' = 8 data, 1 stop 

1 = 7 data, 1 stop 

2=6 data, 1 stop 

3 = 5 data, 1 stop 

4=8 data, 2 stop 

5=7 data, 2 stop 

6-6 data, 2 stop 

7=5 data, 2 stop 
I ;Enab1e video echo. 
K {Disable LF. 
L {Enable LF. 

nnnN ;Set line width to nnn. Disable video echo. 
nnnP ;Set parity bits to nnn. nnn sane as SS card. 

0,2,4,6 = none 

1 = odd 

3 = even 
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^ = rtart: - 

7 = scace 
Z ;D!5dbIe future connanas. 
nnn ;Set I me width to nnn. 
*x ;Set connand char to *x. 

Special note for ppoorans using the hardware directly 

The 6502 processor does a false read before write when doing indexed write operations. Uhen writing to 
the transnit register, the false read would read fron the receive register causing the loss of data. This can 
be avoided by using a base address that is in a different page than the final address. For example, the usual 
way for a progran to store to the transnit register is; 

LDX «20 ;X = Slot 2 * 16 
STA $C088,X jCauses false read 

The way to avoid it is: 

LDX t$BO ;X = Slot 2 * 16 * $90 
STA $BFF8,X ;0n a different page 

House 

The mouse now has the added feature of allowing the user to specify the bounds for the nouse. The 
pointer for the routine, called CUVIPMOliSE, is at $C417. 

CLAMPMOUSE - Sets the nouse window 

Input: A = $00 for X axis, $80 for Y axis 

X = $C4 

Y = $40 

$478 = Low byte of nininun bound 

$4F8 = High byte of nininun bound 

$578 = Low byte of naxinun bound 

$5F8 = High byte of naxinun bound 
Output: A,X,Y undefined 

CLEARMOUSE will set the nouse position to the upper left corner of the window instead of 0,0. 
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